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This month, Wilf Hey 
gives an injection of new 
power into GW-BASIC, a 
much underrated 
language. 


y wife Barbie is well known 
for her malapropisms — that’s 
the unconscious confusion of 


one word for another that somehow 
seems right. On one occaison, utterly 
frustrated with Barbie for modifying our 
plans at a moment’s notice, I appealed to 
her to be reasonable. Her response? 
“Don’t forget — it’s a woman’s 
provocative to change her mind’. This 
month, we are going to exercise the 
programmer’s provocative — to extend 
the powers of a programming language. 


POWER TO THE PEOPLE 
GW-BASIC is a real programming 
language, despite the scorn piled on it by 
some so-called ‘real’ programmers. GW- 
BASIC does fail, though, on several 
counts where the likes of C, PASCAL 
and others excel — one of these being 
interrupt programming (calling MS- 
DOS interrupts, like the video interrupt 
10h — 10 in hexadecimal — directly). 
Well, we are going to change that, 
and give your GW-BASIC programs the 
ability to use interrupts freely. Your PC 
software is equipped with several 
software interrupts — general purpose 
routines that are quite easy to understand 
— grouped into two main classes. There 
are BIOS (BASIC Input/Output System) 
routines and MS-DOS routines (mainly 
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those asociated with reading and writing 
files and covered by the interrupt 21h 
service routines). 

You can add this ability to your own 
programs using the GW-BASIC source 
code in /nterrupting GW-BASIC, though 
there are a few points to note. The first 
of these is that you may have to change 
the line numbers to suit your own 
program. If your programs use the same 


line numbers as the routine they may 
need to start higher than those in the 
text. This will not alter the way it works 
though it does mean that you will have 
to alter the line number referred to by 
the RESTORE statement (currently 
10,090) to refer to the new line number 
at the beginning of the data statements. 

Once the code is in your own 
program you must insert a GOSUB as an 
early instruction to run the routine — 
which will then POKE several 
Assembler instructions into memory. 
This GOSUB — and this routine — should 
be performed only once during the 
program. It must refer to the line that is 
currently numbered 10,000. 

Ensure that you do not use the 
variable IR in your program for your 
own purposes — it’s needed when you 
actually make a CALL to the interrupts. 
Finally, when you start the GW-BASIC 
interpreter, use the /M parameter (to 
prevent the interpreter writing over the 
assembler routine, once it gets into 
memory); it should appear as 
GWBASIC /M:60000. This tells the 
interpreter just what memory location it 
should regard as the top of memory. 

If you do have other Assembler 
routines that you POKE into memory, 
you may wish to modify the first line 
(which controls where in memory this 
one will be placed) so that it doesn’t 
interfere with those other routines. If you 
do this, remember to change the way 
you load the interpreter — the /M option 
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must point to the lowest routine to be 
protected from overwriting. 


PARAMETERS FOR AN 
INTERRUPT 

Programmable PC interrupts make use 
of physical registers, available normally 
only to Assembler programmers. With a 
little interface routine (such as the one 
for GW-BASIC included this month), 
these registers can be used simply as if 
they were numeric parameters. 

The registers we use in connection 
with interrupts are AH, AL, BH, BL, 
CH, CL, DH, DL, SI, DI, DS, ES, and 
FLAGS. Those ending with H or L are 
one-byte registers, and the others are 
two-byte registers; in BASIC, an 
INTEGER variable fits the bill, and that 
is what this interface routine expects. 

Using the code supplied, you can 
make your GW-BASIC program execute 
an interrupt subroutine. First set the 
desired input values. They should all be 
variables of INTEGER type — either 
specified automatically with DEFINT, or 
with a % appended to the name. You will 
need one for each register (except DS — 
which will not change), and one for the 
interrupt number itself. Suitable names 
are INTPT%, AH%, AL%, BH%, BL%, 
CH%, CL%, DH%, DL%, S1%, DI%, 
ES%, and FLAGS%. (Remember to 
ensure that the variable IR — which 
points to the Assembler routine — is 
secure, and remains unchanged by any 
other part of your code). 

The ES register is a special case; it is 
a segment register, associated usually 
with DI (which holds an ‘offset’ 
address). In GW-BASIC, all of your 
program is in the same segment, so DS 
and ES need to be the same. Because of 
this (and because you don’t know the 
value in DS), you should set the ES 
parameter to the special value —1 (minus 
one) to let the interface routine know to 
make DS and ES the same. 

The FLAGS register value needn’t be 
set before calling the interrupt, but many 
interrupt routines put a value into 
FLAGS to indicate success or failure; 
make sure a variable exists for this. 

Execute the interrupt routine using 
the following code: 
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CALL IR(INTPT%, AH%, AL%, BH%, 
BL%, CH%, CL%, DH%, DL%, SI%, DI%, 
ES%, FLAGS%) 


which must all be on the same line. It’s 


worth remembering that there is a 254 (decimal) for MS-DOS. The BIOS of interest. These values, and their 
character limit on a line in GW-BASIC services more often relate to keyboard, meanings, are as follows: 
so don’t make your variable names for screen or printer functions. Most other 
this command too long. things (mainly disk handling routines) 0 — no carry not zero 
Most interrupt services use register are dealt with by MS-DOS services. 1 — carry not zero 
AH as a special value — to indicate After the interrupt service is 64 — no carry zero 
which interrupt service you want. The completed, FLAGS% is set to one of four 65 — carry zero 
variable INTPT% will normally be set to _ easily-tested values — because there are 
16 (decimal) for BIOS or to 33 normally only two flags that willever be _In almost all cases, the ‘zero/not zero’ 
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& 19.95 The Lot. 


The very best of Public Domain and Shareware. 
Selected from thousands available, 40 separate programs. 
Covering all the major applications at less than 50p each. 

Priced as the authors intended - CHEAP. 


Utilities. 


Time Run. 

Automatically execute a DOS com- 
mand, program or batch file at a 
specific date and time, very useful. 


Utilities cont. 
Hard Disc Backup. 


Safe but quick, a comprehensive 
hard disc backup utility. 


Communications. 
Procomm UK. 


One of the first, much copied, but 
still one of the best. 


Database. 
PC-File V. 


The definitive flat file database for 
the PC, very popular, in use by 
thousands. 


Calculator. 
The best pop up calculator there is, 
its got everything. 


Eazilink. 
Supports Prestel and Viewdata for- 
mats on a PC, has to be seen to be 
believed, excellent. 


Wampum. 
The best dBase Ill Clone, supports 
all major dBase functions and file 
formats. 


Quickmenu. 
Neat menuing system that searches 
hard disc and automatically creates 
menus for most major applications. 


List. 


Now up to version 6, superlative file 
viewer. 


Disc Commando. 

Knocks Sidekick into a cocked hat. 
Includes Menuing, graphic tree sup- 
port, calculators, appointment calen- 
dar etc. etc. etc. 


Printer support. 
Print Partner. 


Print banners plus all manner of 
other goodies for your printer. 


“4rd processing. 
PC Type Il. 


The most popular shareware word 
processing program on the PC. A 
personal favourite. 


PC Write. 


Full featured word processing includ- 
ing spell checking and mail merge 
and outstanding printer support. 


Automenu. 

The finest menuing system for PC's 
includes mouse support and on line 
help. 


Menu. 

Very small but powerful menuing 
program for batch files, a personal 
favourite. 


Clock. 


Puts a clock on screen. 


Go. 


Jump to the sub directory that con- 
tains the specified file. 


PKArc. 


The premier file archiver, very latest 
version, smaller and faster than 
ever. 


Global. 


Performs any DOS command on ail 
subdirectories. 


Dos-Edit. 
Remembers DOS command lines for 
easy recall, every AUTOEXEC.BAT 

file should have this. 


Sideways. 


Print files sideways on your printer, 
invaluable for large spreadsheets. 


Xprint. 


Re-direct printer output to a file. 


Masterkey. 


Un-delete files and much more. 


HD Test. 
One of the most thorough hard disc 
testing programs available. 


‘Spreadsheets. 
As Easy As. 


All singing and dancing spreadsheet 
for the professional user, can read 
and write Lotus 123 files. 


PC Calc. 


Lotus 123 clone, shareware at its 
best, outstanding quality. 


Games. 


Captain Comic. 

The best shareware game available, 
you will be amazed at the colours 
(EGA). 


Educational. 
PC-Touch. 


Typing tutor with constant display of 
your performance. 


Spellbound. 


Superb spelling tutor with animated 
colour graphics. 


Cyrus Chess. 


My favourite chess game, very 
powerful (EGA). 


Golf. 


The best version of this popular 
classic. 


Computer tutor. 


A must for all new computer users. 


[ P& Graphics. 


PC Key Draw. 

Fantastic drawing program complete 
with easy to use tutorial and demo 
files, a real must. 


VGA CAD V2.2 


Outstanding CAD package, outper- 
forms many commercial programs. 


Memory. 
Short and sweet, shows how much 
memory you have. 


Concentration. 
A real classic game in stunning VGA 
colour. 


DOS Learning system. 
Covers all aspects of DOS especially 
recommended for new DOS users. 


Word Wizz 


Very good vocabulary quiz. 


Mail Order 


W. P. S. 
9A Ingrave Road 
Brentwood Essex 


Telephone Orders 


0277 263200 


Plus £ 150 Post and Packing 


Re-boot. 


Causes the computer to re-boot. 


Adventures of Kroz. 


75 play fields and more than 1000 
characters will run on all systems. 


| have always been a fan of public domain and shareware software right back to it’s early 
days on CP/M computers. But two things spoil the idea. 


1. Most of it is not that good, or of very limited appeal. 


2. Most Shareware vendors charge FAR to much. 


| have spent several months testing the multitude of software available, talking to other 
users to compile this list of the VERY BEST in public domain and shareware. 


All the above titles have been tested thoroughly, they all work and work well. In many 
cases better than their commercial counterparts. 40 programs in all, available on all disc 
formats, all at the same price. All disc’s are guaranteed to read, and are 100% Virus free. 


40 programs for & 19.95, less than 50p each, now that’s value. The same selection from 
one of the 'Big Boy’ vendors would cost you in excess of & 80.00 


The package includes full instructions on how to install all of the programs, many of which 
include tutorials and/or on-line help. 
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flag is of no real use, so both | and 65 
mean ‘carry’. Be sure to test for all these 
values in your programs. 

One more thing; be sure to initialise 
the variables before using them in the 
CALL, or you may inadvertently cause 
addressing problems. This is most easily 
done by setting each of them to zero 
early in the program. This is just so that 
the GW-BASIC knows about them, and 
doesn’t need to conjure them on the spot 
when it first sees the CALL. 


ACTION TIME 

There are lots of things you can do with 
an interrupt routine. Let’s do something 
simple just to try it out. BIOS interrupt 
12h (18 decimal) tells you the size of 
normal memory in the PC (which means 
the memory up the 640K MS-DOS 
limit). It will return the value in registers 
AH and AL, using the formula SIZE (in 
K) = 256 x AH + AL. Try it out. No 
matter how badly things go wrong the 
worst that can happen is that you will 
have to re-boot your PC. 

If you decide to go further and read a 
book on interrupts it will often speak of 
register AX. This is just AH and AL 
taken together, with AX = 256 x AH + 
AL. If you have to pass a value to the 
interrupt in AX, you should have code 
like the following (let’s say it’s in the 
variable VALUE%): 


AH% 
AL% 


VALUE% / 256 
VALUE’ AND 255 
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Similarly, if the manual tells you that a 
result is in AX, you can calculate this, 
after the CALL, as: 


VALUE% = 256 * AH% + AL% 


Exactly the same applies to the BX, CX 
and DX registers — which are just ways 
of joining up the ‘H’(high) and ‘L’ (low) 


parts of a register. That covers most of 
the problems. You can now use this 


routine to enhance your own programs. 


UP AND COMING 
Future Programmers’ Workshops will 
highlight any and all programming 
languages and concerns. We’d like these 
to reflect your interests so please send 
ideas, questions, answers to challenges 
and new challenges to: 


Wilf's Programmers’ Workshop 
PC PLUS 

30 Monmouth Street 

Bath BAI 2BW 


